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<?xml version="1.0" encoding="UTF-8 M ?> 
<!DOCTYPE objType SYSTEM "objTypes.dtd"> 
<objType objTypeNumber=" 1 " objTypeName="sem" objTypeHandler=" 
symbolTableName="semClassId"> 
<objTypeAttributes> 

<objTypeAttribute key- 'objTypeVisiblityLeve]"> 
<value type="Integer"> 

<literal>l</literal> 

</value> 
<formatStr> 

<literal>%d</literal> 
</formatStr> 
</objTypeAttribute> 

<objType Attribute key="objTypeStringr , > 

<valueStr> 

<literal>Semaphore</literal> 

</valueStr> 
</objTypeAttribute> 

<objTypeAttribute key="objTypeString2 ,, > 

< value Str> 

<literal>Semaphores</literal> 

</valueStr> 
</objTypeAttributc> 

<objTypeAttribute key="objTypeIconLarge"> 

<valueStr> 

<literal>semL.ico</literal> 

</valueStr> 
</objTypeAttribute> 

<objTypeAttribute key="objTypeIconSmall ,, > 
<valueStr> 

<literal>sem.gif</literal> 
</valueStr> 
</objTypeAttribute> 
</objTypeAttributes> 
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<objAttributes> 

<obj Attribute key="objId"> 
<label> 

<literal>ID</literal> 

</label> 
<value> 

<substitute fieldName= ,, objId7> 

</value> 
<formatStr> 

<literal>%08 x</literal> 
</formatStr> 
<detailLevel> 

<literal>l</literal> 
</detailLevel> 
</objAttribute> 

<obj Attribute key="objName"> 
<label> 

<literal>Name</literal> 

</label> 
<value> 

<substitute fieldName= M objName7> 

</value> 
<formatStr> 

<literal>%s</literal> 
</formatStr> 
<detailLevel> 

<!iteral>K/literal> 
</detailLevel> 
</objAttribute> 

<objAttribute key="objOwner"> 
<label> 

<literal>Owner</literal> 

</label> 
<value> 

<substitute fieldName="objOwner"/> 

</value> 
<formatStr> 

<literal>0x%08x</literal> 
</formatStr> 
<detailLevel> 

<literal>l</literal> 
</detailLevel> 
</objAttribute> 
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<objAttributekey-'objHasChildren M > 
<value> 

<switchfieldName=''objChildListPtr M > 
<case caseValue="0"> 

<literal>false</literal> 

</case> 

<case caseValue="*"> 

<literal>true</literal> 

</case> 
</switch> 

</value> 

<formatStr> 

<literal>%s</literal> 

</formatStr> 
</objAttribute> 
<objAttribute key="objType"> 

<label> 

<literal>Type</literal> 

</label> 
<value> 

Substitute fieldName="semType"/> 

</value> 
<fonnatStr> 

<literal>Ox%x</literal> 
</formatStr> 
<valueStr> 

<switch fieldName="semType' t > 
<case caseValue="0"> 

<literal>B inary</literal> 

</case> 

<case case Value-' 1 "> 

<literal>Mutex</literal> 

</case> 

<case caseValue="2"> 

<literal>Counting</literal> 

</case> 

<case case Value-'* "> 

<literal>UNKNOWN</literal> 

</case> 
</switch> 
</valueStr> 
<detailLevel> 

<literal>l</literal> 
</detailLevel> 
</objAttribute> 
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<objAttribute key="objState"> 

<! —There are two label entries here. The first will be overridden by the second, 
if the second does not return a null value when processed, i.e. if the fieldMap contains an entry for the 
"semType" fieldName, the second label will override the first when processed. In the case of a 
getDatabaseAttributesO call, the second will return a null since "semType" will not be in the field map, and 
the value contained in the first will persist.-> 

<label> 

<literal>State/Count/Owner</literal> 

</label> 
<label> 

<switch fieldName="semType"> 
<case caseValue="0"> 

<! -Binary Semaphore~> 
<literal>State<Vliteral> 

</case> 

f j <case case Value-' 1 "> 

^ ;i <! --Mutex Semaphore--> 

* <literal>Owner</literal> 
f& </case> 

<case caseValue="2"> 

I % <!— Counting Semaphore—> 

<literal>Count</literal> 

~Z. </case> 

<case caseValue- '*"> 

s <literal>Owner</literal> 
C3 </case> 
H <7switch> 
U </label> 
q <value> 

<substitute fieldName="semState7> 

lij </value> 
"~ <formatStr> 

<switch fieldName= ,, semType"> 
<case caseValue="2"> 

<! —Counting Semaphore - display as decimal--> 
<literal>%d</literal> 

</case> 

<case caseValue- **"> 

<!-Any other sort of semaphore - display as hex--> 
<literal>Ox%x</literal> 

</case> 
</switch> 
</formatStr> 



Fig. 4e 



<valueStr> 

<! --Override the valueStr, even though the value and formatStr has 
been specified. This allows decoding of the Semaphore statie into plain text. The only option is for a 
Counting, or unknown Semaphore, where no Case Value is specified. This allows the XML code to fall 
through the Switch statement without finding a match. In this case, no value will be inserted into the 
valueStr from here, leaving the XML code to compose one from the contents of the value combined with 
the formatStr.-> 

<switch fieldName="semType"> 
<case caseValue="0"> 

<!— Binary Semaphore—> 
<switch fieldName="semState"> 
<case caseValue="0"> 

<literal>FULL</literal> 

</case> 

<case caseValue="*"> 

<literal>EMPTY</literal> 

</case> 
</switch> 

</case> 

<case caseValue= M 1 "> 

<!~Mutex Semaphore--> 
<switch fieldName="semState"> 
<case caseValue="0"> 

<literal>Unowned</literal> 

</case> 
</switch> 

</case> 

<!--For case Value = 2 (Counting semaphore) or for any 
other value, let this fall through without filling in a value. In this case, a valueStr will be composed 
automatically from the value and formatStr entries-> 

</switch> 
</valueStr> 
<detailLevel> 

<literal>K/literal> 
</detailLevel> 
</objAttribute> 

<objArtribute key="objOptions"> 
<label> 

<Iiteral>Options</literal> 

</label> 
<value> 

<substitute fieldName="semOptions7> 

</value> 
<formatStr> 

<literal>0x%08x</literal> 
</formatStr> 
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<valueStr> 

<typedef> 

<switch fieldName-'semOptions" fieldMask="0x0003"> 
<case caseValue="0"> 

<literal>SEM_Q_FIFO</literal> 

</case> 

<case case Value-' 1"> 

<literal>SEM_Q_PRIORITY</literal> 

</case> 

<case caseValue- '*"> 

<literal>SEM_Q__UNKNOWN</literal> 

</case> 
</switch> 

<bitfield fieldName-'semOptions" 

fieldMask="OxFFFFFFFC"> 
<bit mask="0x0004 ,, > 

<literal>SEM_DELETE_SAFE</literal> 

</bit> 

<bit mask="0x0008"> 

<literal>SEM_INVERSION_SAFE</literal> 

</bit> 

<bit mask="*"> 

<literal>SEM_UNKNOWN</literal> 

</bit> 
</bitfield> 
</typedef> 
</valueStr> 
<detailLevel> 

<literal>l</literal> 
</detailLevel> 
</objAttribute> 

<obj Attribute key= ,, objIconSmall"> 
<valueStr> 

<switch fieldName="semState"> 
<case caseValue="0"> 

<literal>sem.gif</Hteral> 

</case> 

<case caseValue="*"> 

<literal>semempty.gif</literal> 

</case> 
</switch> 
</valueStr> 
</objAttribute> 
</objAttributes> 
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<objGopher> 

<switch fieldName="cpu"> 

<case caseValue- '*"> 
<program> 

<! -Default Get object info for sem - taken from PPC860- 
<![CDATA[! <+0x3O*<+Ox3O@» 
<+0x28*$><+0x20*!><+0x8@>%nameLookup%<+0x34@b><+0x35@bx+0x48@>]]> 

<program> 

<tape> 

<field fieldName="objId7> 
<field fieldName =,, objTypeNumber"/> 
<field fieldName="objName7> 
<field fie]dName="objOwner"/> 
<fieldfieldName="objChildListPtr7> 
<field fieldName="semType"/> 
<field fieldName- 'semOptions7> 
<field fieldName="semState"/> 

</tape> 

</case> 
</switch> 
</objGopher> 
<enumByType> 

<switch fieldName =,, cpu"> 

<case caseValue="*"> 
<program> 

<![CDATA[*+0x38** -0x18! <+Ox30*<+0x30@» 
<+0x28*$><+0x20*!x+0x8@> <+Ox34@bx+0x35@bx+Ox48@>+Oxl8@]]> 

</program> 
<tape> 

<field fieldName= n objId7> 
<field fieldName="objTypeNumber'7> 
<field fieldName="objName7> 
<field fieldName="objOwner , 7> 
<field fieldName= M objChildListPtr7> 
<field fieldName="semType7> 
<field fieldName="semOptions"/> 
<field fieldName="semState ,, /> 
<field fieldName="objSiblingPtr7> 

</tape> 
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<program> 

<![CDATA[%objSiblingPtr% -0x18! <+0x3O*<+Ox3O@» 
<+Ox28*$><+0x2O*!><+Ox8@><+Ox34@bx+0x35@b><+Ox48@>+Oxl8@]]> 

</program> 
<tape> 

<fie!d fieldName="objId7> 
<field fieldName=''objTypeNumber7> 
<field fieldName="objName7> 
<field fieldName- 'objOwner7> 
<field fieldName= M objChildListPtr7> 
<field fieldName="semType7> 
<field fieldName= M semOptions7> 
<field fieldName="semState7> 
<fieldfieldName="objSiblingPtr7> 

</tape> 

</case> 
</switch> 
</enumByType> 
</objType> 
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<?xml version="1.0 M encoding"utf-8"?> 
<object name- 'binary Semaphore" 

icon- 'k:\wpwr\host\resource\bitmaps\ WindView\events\semBCreate.bmp"> 

<helpText> 

<synopsis> 

This is a short description of the object. 
</synopsis> 

<description> 

This is a much longer description of the object. 

This description can contain anything the user desires. 
<description> 

</helpText> 

<publicDataGet> 

<helpText> 

<synopsis>Get all public data members</ synopsis> 
<description> A full description of the routine</description> 
</help Text> 

<requestBegin> 

<call name="semRequestBegin"/> 

<return type="UINT8*7> 

<parm type="SEM_ID' , name="semId"/> 

</requestBegin> 

<requestEnd> 

<callname=''semRequestEnd"/> 
<return type= a STATUS7> 
<parm type="UINT8 *" name="pBuff 7> 
</requestEnd> 



Fig. 9b 



<data> 

<dataItemtype=' , UINT''idref='*pkLength"display="never , 7> 
<dataItemtype-"UINT"idref="semId" 

text="Handle ,, format="0x08x"display="always" 

position="17> 

<dataItemtype-"UINr , idref=' , semClassId"display="never"/> 
<dataltem type- 'string" idref- 'name" 

text="Name" format="%s" display="always" 

position="07> 
<dataltem type- 'string" idref-'owner" 

text- 'Owner" format="%s" display="always" 

position="2"/> 
<dataltem type="int"diref^"value" 

text="State , Tormat= ,, translate"display- 'always" 

position="3" 

translate key ="0" value="Empty" format="%s"/> 
translate key='T* value="Taken" format="%s7> 
translate key="*'Value=' 'Unknown" format="%s7> 
</dataItem> 

</data> 



</pubicDataGet> 



